home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / ftn / fbsubt.z / fbsubt
Encoding:
Text File  |  2002-10-03  |  3.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffbbbbttttxxxxlllldddd((((3333GGGG))))                                                          ffffbbbbttttxxxxlllldddd((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffbbbbttttxxxxlllldddd - load part or all of a texture defined with TX_FASTDEFINE
  10.  
  11. FFFFOOOORRRRTTTTRRRRAAAANNNN 77777777 SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      ssssuuuubbbbrrrroooouuuuttttiiiinnnneeee ffffbbbbssssuuuubbbbtttteeeexxxxllllooooaaaadddd(((())))
  13.      rrrreeeeaaaallll
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _x   is the window-relative starting x coordinate of the rectangle in the
  17.          framebuffer that is being loaded into texture memory.
  18.  
  19.      _y   is the window-relative starting y coordinate of the rectangle in the
  20.          framebuffer that is being loaded into texture memory.
  21.  
  22.      _t_a_r_g_e_t
  23.          is the texture target to which the texture we are loading is bound.
  24.  
  25.      _i_d  is the id of the texture we are loading.
  26.  
  27.      _s_0  is the starting S coordinate of the subtexture to load.
  28.  
  29.      _s_1  is the ending S coordinate of the subtexture to load.
  30.  
  31.      _t_0  is the starting T coordinate of the subtexture to load.
  32.  
  33.      _t_1  is the ending T coordinate of the subtexture to load.
  34.  
  35.      _f_l_a_g_s
  36.          is a special modifier.
  37.  
  38. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  39.      ffffbbbbttttxxxxlllldddd loads some or all of a texture that is currently allocated space
  40.      in texture memory by copying a rectangle from the framebuffer using the
  41.      current readsource and readcomponent values.
  42.  
  43.      The transfer uses the scale and bias settings in effect at the time of
  44.      the texdef2d if TX_EXTERNAL_FORMAT, TX_PIXMODE was specified in the
  45.      properties.
  46.  
  47.      The values s0,s1,t0,t1 are mapped to texel values by
  48.      start_s_texel = s0*texture_width;
  49.      start_t_texel = t0*texture_height;
  50.      end_s_texel   = s1*texture_width - 1;
  51.      end_t_texel   = t1*texture_height - 1;
  52.  
  53.      s0,s1,t0,t1 should fall on texels that are a multiple of 32, i.e. for a
  54.      texture that is 256x128, s0,s1 can be
  55.      0,.125,.25..375,.5,.625,.750,.875,1.0, while t0,t1 can be
  56.      0.,.25,.50.,75.,1.0. Results are undefined for any other values.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffbbbbttttxxxxlllldddd((((3333GGGG))))                                                          ffffbbbbttttxxxxlllldddd((((3333GGGG))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75. NNNNOOOOTTTTEEEESSSS
  76.      ffffbbbbttttxxxxlllldddd is supported only on RealityEngine systems with release 5.0.1 or
  77.      greater.
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.